home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 32 / Mac Magazin and MacEasy Magazine CD - Issue 32.iso / Multimedia / MIDI / Midi Typer / !Read Me First! (Text) next >
Text File  |  1996-06-01  |  11KB  |  166 lines

  1.  
  2.  
  3.  
  4.  
  5. Midi Typer
  6. (Version 1.0.4)
  7.  
  8. Table of Contents
  9.  1) What is it?
  10.  2) How much does it cost?
  11.  3) How does it work?
  12.  4) How does it really work?
  13.  5) Where can I find the latest version?
  14.  6) Limitations and room for improvement
  15.  7) Legal Stuff
  16.  8) Praise, Complaints, Offers of jobs…
  17.  9) Update notes
  18.  
  19.  
  20. 1. What is it?
  21.  
  22. The short answer
  23.  
  24. Midi Typer is a drag-and-drop utility. It convinces your system that all those MIDI files you downloaded (or bought) really are MIDI files. This is often a problem with MIDI files created for other computer systems, even though the data format for MIDI files is identical among all computer systems. 
  25.  
  26. Midi Typer is smart enough to automatically distinguish between real MIDI files and other kinds of documents (such as this documentation), so you can just drop the icon of a folder or disk on Midi Typer, and it will do the rest. You can also use Midi Typer to change the application that will open your Midi Files.
  27.  
  28. Midi Typer requires System 7.0 or greater.
  29.  
  30. The long answer
  31.  
  32. Macintosh users who download MIDI files (or buy them from commercial collections) are often faced with the problem that their MIDI software refuses to recognize the downloaded file—they won’t even show up in the standard Open File dialog. The problem is that the Finder thinks your MIDI files are really text-only documents. (This description is somewhat simplified; the “How does it really work?” section goes into more detail.) 
  33.  
  34. You can, of course, solve this problem by using any of a number of utilities (ResEdit and DeskTop come to mind immediately), but you have to manually change information for each file individually. With Midi Typer, you just drag a bunch of icons onto Midi Typer, and it does the rest. You can also specify an application to open your Midi Files with, so that you can double-click on the Midi File and have it opened in your favorite sequencer, notation program, or Max.
  35.  
  36. There are other utilities for automatically changing file types. Midi Typer is unique in that it actually looks at the data in your file to check if it is, indeed, a MIDI File. There’s no point in trying to open a “Read Me” document with your sequencer. 
  37.  
  38. 2. How much does it cost?
  39.  
  40. Nothing. You must, however, read Section 7 (“Legal Stuff”) before you may use Midi Typer. 
  41.  
  42. 3. How does it work?
  43.  
  44. The first time you use Midi Typer, you should open the application directly (either select Midi Typer and choose Open from the File menu or double-click on Midi Typer’s icon). You can choose which MIDI program you want to open your MIDI files with from the Open With menu (Figure 1). 
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55. If your MIDI program is not listed in the menu, choose Select Other Application…, and you can specify any application you want to in a standard Open File dialog (Figure 2).
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62. Once you’ve specified which MIDI Application to use, go back to the Finder, select your Midi Files, drag them over to Midi Typer, and when Midi Typer’s icon is highlighted, just drop ’em. When you’re finished with Midi Typer, you can quit the application.
  63.  
  64. Once you’ve specified your sequencer, you can just drag-and-drop files, folders, and even entire disks onto Midi Typer. It will make all the necessary changes and quit automatically. If you ever want to change the application used to open your Midi files, just open Midi Typer and make the appropriate choice in the Open With menu.
  65.  
  66. The current version of Midi Typer provides almost no feedback while it’s running. This is regrettable; however, processing is generally over so soon (I get about 10 files/second on a Mac IIfx) that I haven’t felt the effort involved in creating a progress dialog was justified. 
  67.  
  68. If you would like to see improvements made, write to me. My address is at the end of this document. Don’t expect too much—this is a freeware project.
  69.  
  70. 4. How does it really work?
  71.  
  72. The following information is of a technical nature. You do not need to understand it to use Midi Typer.
  73.  
  74. The problem with most downloaded MIDI files (and with MIDI files taken from other systems) is that the files have the OSType 'TEXT' instead of 'Midi' in the file type field of the Finder Information record. Midi Typer looks at every file dropped on it and, if the first 20 bytes comprise a valid MIDI file Header Chunk, changes the file type and creator fields. I considered making Midi Typer look at the entire file, but all MIDI software I know of makes sanity checks while interpreting MIDI Files, so the chosen solution seems satisfactory. It is also fast enough that a progress dialog is not absolutely necessary. 
  75.  
  76. Midi Typer is based on Paul Hoffman’s Dragonsmith application framework (v. 1.1.1) and was developed using Think C (v. 6.01). If you want to write your own drag-and-drop applications, you can find Dragonsmith at a number of archive sites—try the Info-Mac archives at Sumex-aim (ftp://sumex-aim.stanford.edu/) or the archives at University of Michigan. Dragonsmith relies several on several System 7.0 features (in particular, Apple Events), so don’t expect any joy under older system versions.
  77.  
  78. 5.    Where can I find the latest version?
  79.  
  80. The reference (i.e. most up-to-date) version is maintained at ftp://ftp.prz.tu-berlin.de/pub/MusicAnalysis/Utilities/
  81.  
  82. (The server is a Unix machine, so watch the capitalization on the path!).
  83.  
  84. Midi Typer (not necessarily the latest version) is also available at Info-Mac and U. Michigan archives (and their mirror sites), and the Opcode ftp site. It has also been included on CD-ROMs published by MacWorld España, the IEEE, and others. I maintain a list of links at my WWW Site, the links should be at http://www.prz.tu-berlin.de/~pcastine/Music/programs.html
  85.  
  86. 6.    Limitations and room for improvement
  87.  
  88. •    No progress indicator. Not a problem for ten to twenty files, but if you drop your hard disk on Midi Typer, the program will need some time. At least it works cooperatively in the background and you can interrupt it with Command-Period.
  89.  
  90. •    Similarly, no notification of errors. 
  91.  
  92. •    Midi Typer trusts you when you select an application using the Select Other Application command. If you tell it that you want to open your MIDI files with Excel, it will obediently do so. I have no idea what Excel will do with a MIDI file. 
  93.  
  94. •    Midi Typer has no Open command in the File menu. The only way to initiate file processing is with drag-and-drop. 
  95.  
  96. •    Midi Typer will not go further than twenty levels deep when looking at folders within folders within folders. This prevents problems that can arise if you put an alias to a folder inside the folder the alias points to (if you know what infinite recursion is, you’ll recognize the problem).
  97.  
  98. •    Midi Typer is still pure 68000 code. As long as most of the File System is emulated, there's not much point in generating PPC code—it would just make Midi Typer fatter, not faster. 
  99.  
  100. •    Some future version of Midi Typer may offer you an option to strip off those stupid .MID suffixes from the file name. 
  101.  
  102. • Warning: If you used a pre-release version of Midi Typer, you must delete the old Preferences file (inside the Prefences folder in your System Folder). It is incompatible with this version of Midi Typer.
  103.  
  104. Judging from the responses I've gotten over the past two years, nobody really needs any of these features. Or maybe nobody reads documentation anymore? (Ha ha! Now I can do all sorts of Dave Barry-style insults! But, no! Surely everyone reads the licensing information?!? Maybe I'll include a clause in the next version requiring that the user offer me his or her first-born…)
  105.  
  106. 7.    Legal Stuff
  107.  
  108. •    Copyright
  109.  
  110. Midi Typer is Copyright © 1994-96 by Peter Castine. All rights reserved.
  111.  
  112. •    License
  113.  
  114. Midi Typer (the Software) is provided by Peter Castine (the Author) free of charge and may be distributed free of charge, provided that this documentation is included unchanged with the software. YOU MAY NOT SELL THE SOFTWARE, NOR MAY YOU TAKE A FEE OR COMMISSION FOR PROVIDING THE SOFTWARE TO ANOTHER PERSON, NOR MAY YOU INCLUDE THE SOFTWARE WITH OTHER SOFTWARE THAT IS SOLD FOR A FEE WITHOUT PRIOR WRITTEN PERMISSION FROM THE AUTHOR. 
  115.  
  116. Permission is herewith granted for making the software available on electronic data services (‘Bulletin Boards’) and FTP-Archive Servers providing that the documentation and software are included without change or abridgment.
  117.  
  118. License arrangements for bundling in other cases are easy, but you must contact me.
  119.  
  120. •    Disclaimer of Warranty on Software
  121.  
  122. THE SOFTWARE IS PROVIDED “AS IS” AND WITHOUT WARRANTY OF ANY KIND. The Author expressly disclaims all warranties, express or implied, including, but not limited to, the fitness for a particular purpose. The Author does not warrant that the software will be uninterrupted or error-free, or that defects in the software will be corrected. Furthermore, the Author does not warrant or make any representations regarding the use or the results of the use of the software  in terms of their correctness, accuracy, reliability, or otherwise. No oral or written information or advice given by the Author shall create a warranty or in any way increase the scope of this warranty. Should the software prove defective, you (and not the author) assume the entire cost of all necessary servicing, repair or correction of the software, or the computer system with which it is used.
  123.  
  124. •    Limitation of Liability
  125.  
  126. UNDER NO CIRCUMSTANCES, INCLUDING NEGLIGENCE, SHALL THE AUTHOR BE LIABLE FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES THAT RESULT FROM THE USE OR INABILITY TO USE THE SOFTWARE, EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  127.  
  128. That’s it. Note that, at the time of this writing, I have every reason to believe that the software will work as advertised and that it will not cause any damage. I just cannot test it on every possible Macintosh configuration, so, caveat emptor.
  129.  
  130. 8. Praise, Complaints, Offers of jobs…
  131.  
  132. Send them all to:
  133.  
  134. Peter Castine
  135. Wildganssteig 28
  136. 13503 Berlin
  137. Germany
  138.  
  139. e-mail:    pcastine@prz.tu-berlin.de
  140.  
  141. (You may also want to check out my WWW Site at http://www.prz.tu-berlin.de/~pcastine) 
  142.  
  143. If your favorite MIDI program is not currently on the menu, you can send me a postcard or e-mail with the program’s name and creator code. I’ll get it into the next version of Midi Typer. If you send the information by e-mail, I’ll e-mail the new version back to you. 
  144.  
  145. And special thanks to the folks who've sent postcards, e-mail, etc!
  146.  
  147. 9. Update notes
  148.  
  149. Not very precise, but there've been more important things to do…
  150.  
  151. v. 1.04 (1 June 1996): Added Overture and Finale 3 to the Open With menu, (distinguishing Fin3 from earlier versions), updated documentation, dropping MS-Word version of documentation in the process (SimpleText's styled text is good enough, and who wants to maintain two versions of documentation?)
  152.  
  153. v. 1.03  (1995 or early 96): Added MidiJukebox to the Open With menu.
  154.  
  155. v. 1.02 (June 26, 1994): Added an item or two to the Open With menu
  156.  
  157. v. 1.01 (May/June 1994): Added Cubase (I think) to the Open With menu
  158.  
  159. v. 1.0 (May 13, 1994): First “public” release
  160.  
  161. v. 1.0 beta (late Apr. 1994): Beta test release. It shouldn't have gone outside of Berlin, but it was on one (non-public) file server, so who knows where it got to?
  162.  
  163. -------------------------------------------
  164. 1 June, 1996        Midi Typer Documentation
  165.  
  166.